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MISC () 8/12/77 


misc — other changes to Sixth Edition manual 


SECTION I 


Minor differences exist in the following commands: 


file Doesn't recognize Interdata assembler source 
mail mail file is in /usr/mail/<uid>, not .mail 
nm New option: 


-h Print addresses in hexadecimal 


nroft Level 6 manual is obsolete - see “new blue b 
od -a option displays Interdata assembler op-co 
opr destination operand is ignored. 


MISC () 


files. 


ook". 


des. 


passwd if typed without arguments, promts for a new pass- 


word for the current user. -e flag turns o 
ing while the password is entered. 
tp -Q option takes first filename argument as a 

be used instead of a tape drive. 

Not Implemented 

Commands marked with * are to be considered 
soon", 

*be cdb — see ddt (I) 
db - see ddt (TI) sdg eqn 
fortran — see fort (TI) libr Tin 
man pfe rev 
roff ~ see nroff (I) spell 

troff = see troff (TI) *typo 


SECTION III 
Only the following subroutines are available 


abort 

alloc, free atof 

atoi crypt 
ctime end, etext, 
getc, getw, fopen getpw 
getchar ldiv,lrem 
monitor perror 
printf putc, putw, 
putchar, flush qsort 
reset, setexit ttyn 


monitor () requires an extra fifth argument, 


SECTION VI 
Only the following commands exist: 
cal chess col quiz 
sno tbl units 


SECTION VIII 


ff echo- 


file to 


“coming 


— see neqn (I) 
k 


edata 


fereat, fflush 


which must be 0 


MISC () 8/12/77 MISC () 


The dpd command requires hardware which we don't 
have! 
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NAME 
al - create empty files 
SYNOPSIS 
al [-mode] file ... [-mode] file ... 
DESCRIPTION 
Creates the specified files, or truncates them to zero 
length if they already exist. 
mode Octal value of access mode (as in chmod(T)) to be 
given to following files. 
AUTHOR 


Ross Nealon 
University of Wollongong 
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NAME 
ar - archive and library maintainter 

SYNOPSIS 
ar [-]key [ posname ] afile [ name ] ... 

DESCRIPTION 
ar maintains groups of files combined into a single archive 
file. Its main use is to create and update library files as 
used by ld. It can be used, though, for any similar pur- 
pose. 
key is one character from the set `drtmx', optionally con- 
catenated with ‘vuaib'. afile is the archive file. The 
names are constituent files in the archive file. The mean- 


ings of the key characters are: 
d delete the named files from the archive 


r replace the named files in the archive. If the op- 
tional character u is used with r, then only those 
files with modified dates later than the archive 
files are replaced. If the optional positioning 
character a (also i) is used, then the posname argu- 
ment must be present and specifies a file in the ar- 
chive after (before for i) which new files are in- 
serted. If no names are given, all files present in 
the archive which are also presnt in the current 
directory are replaced. If the archive file does 
not exist, r creates it. If the named files are not 
already in the archive, they are appended. 


t print a table of contents of the archive file. TE 
no names are given, all files in the archive are 
tabled. If names are given, only those files are 


tabled. 

p prints the named files in the archive to standard 
output 

m moves the named files to the end of the archive. If 


the options i or b are used, then the posname argu- 
ment must be present and specifies where the files 
are to be moved. 


x extracts the named files. If no names are given, 
all files in the archive are extracted. In neither 
case does x alter the archive file. 


v verbose option: ar gives a file-by-file description 
of the making of a new archive file from the old ar- 
chive and the constituent files. When used with t, 
it gives a long listing of all information about the 
files. 


AR(I) AR(I) 


FILES 
/tmp/v# temporary 


SEE ALSO 
ld{I), archive (V), arcv({I) 
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NAME 
arcv - convert old archive files to new format 


SYNOPSIS 
arcv file 


DESCRIPTION 
Converts each file (assumed to be old archive format) to the 
new format. Each file is rewritten. 


FILES 
/tmp/arc# 


SEE ALSO 
ar (I) 


DIAGNOSTICS 
"Bad archive format" — file was not in old archive format. 


AS (T) 


NAME 


AS (I) 


as — UNIX Interdata assembler 


SYNOPSIS 


as [ -u ] [ -m] [ -sN ] [ -o object-file ] file [... ] 


DESCRIPTION 


Assembles the Interdata CAL source code in the named 
file(s), leaving the object—code output on a.out. Tf multi- 
ple filenames are given, only the last may have an END 
statement; they are concatenated together and assembled as 
one program. 


-u Uppercase characters (other than those within quoted 
strings) are to be translated to lowercase. 

-m Multiple redefinitions by EQU statements are to be 
considered legal (mainly for the benefit of the stu- 
pid Interdata Fortran V compiler). 

-o Leave the object-—code output on the file named by 
the next argument, instead of "a.out"™. 

-sN Specifies the extent of 'SQUEZ' optimization per- 
formed. 

-s0 NOSOZ - use longest form of all instructions 
-s1 NORX3 - squeeze RX3 instructions to RX2 or RX1 
{where possible) 
-s2 SQUEZ - shorten all possible instructions: 
RX branches to SF branches 
RX3 instructions to RX2 or RX1 
RI1l instructions to SF or RI2 
The default is -s2 (full SQUEZ optimization). 


The input format is compatible with 32-bit CAL assembly 
language, with the following main exceptions: 

— if ~“-u' is not specified, opcodes must be lowercase, 
and uppercase and lowercase symbols are distinct (FRED 
is different from fred) 

— fields may be separated by tabs and/or blanks 

— a BSS pseudo-op is available for defining storage in 
the uninitialized data segment, as well as the text 
(PURE) and initialized data (IMPUR) segments. There 
is no ABS segment. 

- external references and common-block members may be 
used in assembly expressions 

- data definitions of type D'', E'' and T'', and exter- 
nals of type Z() are not implemented 

— pseudo-ops BATCH, CAL, COPY and TARGT, and symbols 
ABSTOP, PURETOP and IMPTOP are not implemented 

- no listings 


AS (T) 


DIAGNOSTICS 


AUTHOR 


A: 
B: 
Cx 
D: 
E: 
G: 
I? 
L: 
M: 
N: 
O: 
Ps 
QO: 
R: 
Si 
U2 
Ws 
xX: 
Zs 


AS (I) 


previously—defined absolute symbol required 
short branch out of range 

illegal or missing opcode 

illegal data within COMN, STRUC or BSS 
unexpected input after the END statement 
garbage character 

illegally nested IF, COMN, or STRUC 

missing label 

multiply defined symbol 

syntax error in number 

org to illegal address 

symbol value changed between assembly passes 
missing quote 

relocatability error 

missing symbol 

undefined symbol 

illegal value (e.g. register field > 15) 
syntax error 

division by 0 


Richard Miller 
University of Wollongong 
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NAME 
beep - ring typewriter bell 


SYNOPSIS 
beep 


DESCRIPTION 
Writes the character '\007' (BEL) on file descriptor 2. 
Useful to signal completion of command files. 


AUTHOR 
Anonymous 


BS (1) BS (T) 

NAME, 
bs — backspace-delete filter 

SYNOPSIS 
bs 

DESCRIPTION 
bs copies from standard input to standard output; when an 
ASCII backspace character is encountered, it and the previ- 
ous character are deleted (unless the previous character was 
EAT) It is useful after forgetting to change the erase 
character with stty before an edit session. 

BUGS 


Maximum line length is 256 characters. 


cc (T) Cc (T) 


NAME 
ee. = compiler 

SYNOPSIS 
cc [-c] [-p] [-o out] [-Ddef] [-Udef] [-Ifile] [-S] [-P] b= 
m] file 

DESCRIPTION 
cc is the UNIX C compiler. It accepts three types of argu- 
ments: 
Arguments whose names end with ~.c' or ~.s' are taken to be 


C or assembly-language source programs; they are compiled, 
and each object program is left on the file whose name is 
that of the source with `.o' substituted for ~.c'. The °.o' 
file is normally deleted, however, if a single C program is 
compiled and loaded all at one go. 


The following flags are interpreted by cc. See ld (1) for 
load-time flags. 


-c Suppress the loading phase of the compilation, and 
force an object file to be produced even if only one 
program is compiled. 


-=p Arrange for the compiler to produce code which counts 
the number of times each routine is called; also, if 
loading takes place, replace the standard startup rou- 
tine by one which automatically calls the monitor sub- 
routine (III) at the start and arranges to write out a 
mon.out file at normal termination of execution of the 
object program. An execution profile can then be gen- 
erated by use of prof (I). 


-m Allow multiple definitions of extern variables in dif- 
ferent files; for compatibility with earlier versions 
of the PDP-11 C compiler. 


-0 The executable output is placed in out instead of 
a.out. 
-D Makes def defined to the preprocessor. 


-U Makes def undefined to the preprocessor. 


-I Search the directory dir for #include files. 

-s Compile the named C programs, and leave the 
assembler-language output on corresponding files suf- 
fixed ~.s'. 

-P Run only the macro preprocessor on the named C pro- 
grams, and leave the output on corresponding files 
suffixed ~.i'. 


cc (1) 


FILES 


CECE) 


Other arguments are taken to be either loader flag argu- 
ments, or C-compatible object programs, typically produced 
by an earlier cc run, or perhaps libraries of C-compatible 
routines. These programs, together with the results of any 
compilations specified, are loaded (in the order given) to 
produce an executable program with name a.out. 


file.c input file 

file.s assembler source file 

file.o object file 

a.out loaded output 

/tmp/ctm? temporary 

/lib/cpp preprocessor 

/lib/c (01) compiler 

/lib/crt0.o runtime startoff 

/lib/mert0.o runtime startoff for profiling 
/lib/libc.a C library; see section III. 
/lib/liba.a Assembler library used by some routines in 


libc.a; see Section II. 


SEE ALSO 


`` Programming in C- a tutorial,'' C Reference Manual, moni- 
tor (IIL), prot Al), dat- 11); 1d AT), 


DIAGNOSTICS 


BUGS 


The diagnostics produced by C itself are intended to be 
self-explanatory. Occasional messages may be produced by 
the assembler or loader. Of these, the most mystifying are 
from the assembler, in particular `M,' which means a 
multiply-defined external symbol (function or data). 


Double precision is unimplemented (double is synonymous with 
float). 

Alignment of data objects is poorly implemented; in particu- 
lar aggregates (struct, union) are always aligned on full- 
word boundaries and rounded to fullword length. 


There is no unsigned short type. 


Structures containing unions or bit fields cannot be ini- 
tialized correctly. 


CV (I) 8/12/77 
NAME 
cv — number base conversion 
SYNOPSIS 
cv -XY value 
DESCRIPTION 
Arguments are one or more numbers in base X, to be 
in base Y. Each value must fit in a 32-bit word. 
Possible bases are: 
b Binary 
ce Ascii characters 
o Octal 
1 Unsigned decimal integer 
d Signed decimal integer 
h Hexadecimal 
AUTHOR 
R Miller 


University of Wollongong 


CV (I) 


printed 
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NAME 
cvo — convert Interdata object files to a.out format 


SYNOPSIS 
cvo infile outfile 


DESCRIPTION 
Converts the output from the Interdata CAL assembler into a 
UNIX a.out file. 


AUTHOR 
R Miller 
University of Wollongong 


SEE ALSO 
a.out(V), cvtask (I) 


BUGS 
Absolute code is not supported. 
Halfword externals are not supported. 
If input file contains common block initializations (BDATA) 
it must not have any pure or impure segments. 
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NAME, 
evtask — convert Interdata task files to a.out format 
SYNOPSIS 
evtask infile outfile 
DESCRIPTION 
Converts the output from TET32 ({Interdata task establisher) 
to an executable UNIX a.out file. 
AUTHOR 
R Miller 
University of Wollongong 
SEE ALSO 
a.out (V) 
BUGS 


Output file has no symbol table, and both code and data are 
placed in the data segment, since task files contain no re- 
location or symbol information. 
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NAME, 

dcopy - recursively copy directory contents 
SYNOPSIS 

deopy [ -v | input-directory output—directory 
DESCRIPTION 


Copies the tree of directories and files below input- 
directory into output-directory (which must exist and be 
empty). 


=y (Verbose) - prints each filename as it is created 


dcopy searches the input directory, copying each file into 
the output directory. If it encounters a special file, it 
makes an identical special file in the output directory. If 
it encounters a directory, it makes a corresponding one in 
the output directory, and calls itself recursively. 


If the caller is the super-user, the created files and 
directories are given the same owner and modification date 
as the originals. 


DIAGNOSTICS 


All I/O or other errors are reported. 


AUTHOR 


BUGS 


R Miller 
University of Wollongong 


dcopy breaks links and forms duplicate copies of linked 
files. 


DDT (I) DDT (T) 


NAME, 
ddt — dynamic C debugger 
SYNOPSIS 
dat [a.out [core [-]]] 
DESCRIPTION 
ddt is a debugger for use primarily with C programs. It is useful for 
post-mortem and interactive debugging. An important feature of ddt is 


even in the interactive case no advance planning is necessary to use i 
particular it is not necessary to compile or load the program in any 
cial way nor to include any special routines in the object file. 


The first argument is the object program (containing a symbol table) 


not given, "a.cut" is used. If only one argument is given, it is as 
to be an object program. The second argument is a core-image file; if 
given, "core" is used. The core file need not be present. The opt 


third argument specifies that the file being debugged is not a core i 
This feature is used most frequently in examining the memory file /dev 
In order to set breakpoints and execute, the namelist (a.out) file mus 
present and can not be a shared text program. 


Commands to ddt have the following form: 

[<address expression>[, repetition] ]<command>[<display mode>] 
If no address is given, the last displayed address is used (this valu 
accessible by typing the special symbol "."). An address expressio 


optionally be followed by a comma and a number, in which case the co 
applies to the appropriate number of successive addresses. 


Address Expression 


An address expression is an arithmetic combination of operands and o 
tors. Operands may be: 


e.g. main symbol name 
=32 decimal number 
0177 octal number 
Ox3e8 hexadecimal number 
‘a ASCII character 
TERY, two ASCII characters 


The following operators are recognized: 


+ addition 
blank addition 
= subtraction 
multiplication 
division 
mod (remainder) 
OR 
AND 
indirection (postfix operator) 
J array subscription (postfix operator) 


m Agner £ 


DDT (I) 


Evaluation 


sumes that 


DDT (TI) 


proceeds left-to-right. The construction name[expression] 
name is a pointer to an integer and is equivalent to the 


tents of the named cell plus four times the expression. 


Commands 


The command strings are 


/ 


vy 
<new line> 


A 


`s Ne Ne Se Se se v 
Qa o Im 


Qa 


PER 


~ 
oO 


display the contents of the addressed memory locations acco 
to the display mode (default i). 

evaluate and display the address expression according to 
display mode (default o). 

store the address expression {1 word) into the last spec 
memory location, which must be on a fullword boundary. 

if no address expression preceeds the "!", the remainder of 
line after the "!" is sent to UNIX to be interpreted as a 
mand. 

print a stack trace of the terminated program. The calls 
listed in reverse order; the actual arguments to each ro 
are given in octal. 

display fault type. 

display the next memory location according to the cu 
display mode. 

display the previous memory location according to the cu 
display mode. 

Replace dot with the effective address of last instruction 

was displayed (follow the path). 

exit from ddt. 

search equal. 

search not equal. 

set an execution breakpoint. 

clear an execution breakpoint. If no address is given, 
breakpoints are cleared. 

display the location of all execution breakpoints. 

begin execution of the symbolic file at location 0. This 

mand may be optionally followed by a list of character s 
arguments to the program. 

continue execution after a breakpoint. 

display all registers in octal and as symbols. 

display the floating point registers. 
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Display Mode 


The mode characters are: 

octal 

hexadecimal 

decimal 

unsigned decimal 
floating point 
double precision floating point 
symbolic instruction 
address 

byte in octal 

byte in ASCII 

two bytes in ASCII 

s string in ASCII 


-O eH aa 


There are two display modes: one for display contents (/) 


and one 


evaluate (=). When ddt is invoked, the default mode for display con 
is i (instruction) and the default mode for evaluate is octal (o). 
ever an explicit display mode is given, the default mode is set t 


given mode and used thereafter until another mode is given. 


Special Symbols 


Ddt recognizes a number of special symbols. The values of 
symbols may be displayed, modified, and used in expressions. 


Name Meaning Default value 
N last address displayed 
sro user register 0 
SP: user register 1 
r2 user register 2 
ire user register 14 
Sef user register 15 
:sp user stack pointer 
ipe user program counter 
¿ps user processor status 
zm search mask Oxffffffrft 
: lower search limit 0 
29 upper search limit 0x8000 
sk lowest address to 
display as a symbol 0x100 
pa last value typed to user 
za 0 only C symbols 1 
1 C and assembler symbols 
iE maximum symbol offset 0x1000 
to display symbolically 
zf current function for last function called 
accessing local variables 
:sl lowest address on stack 0xe0000 


these sp 
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Symbols 

Variables local to a function (automatic, static, and arguments) are a 
sible by writing the function name followed by a colon ":" followed b 
local variable name (ie. main:argc). The notion of the current fun 
exists and is addressable as the special symbol “:f". The value of 

set to the last function to be invoked whenever a breakpoint is en 
tered. Variables local to the current function are accessible by s 
writing the variable name. The current function can be changed by mo 


ing :f (ie xyz!:f sets the current function to xyz which must be acti 


Examples (each command is terminated by a <new line>): 


EIZ display the contents of tl in the default display mode 

tl= display the address of tl in the default evaluate di 
mode 

t1+40/da display the contents of t1+40 (decimal) in decimal 

p/o displays in octal the contents of the word pointed to b 

: SPp=oO display the contents of the users sp (r7) in octal 

O377!:r2 set the value of the users r2 to 0377 octal 

string/s display the contents of string as ASCII characters 

il/o this is equivalent to funl:il/o if the current function 


is funl and il is a local variable in funl 


xyZ+012 023147 ddt displays the cell value 


xYZ+012 023147 0272! user changes xyz+012 to octal 272 

Searches: 

0100!:8 set lower search limit to 100 octal 

1000!:9 set upper search limit to 1000 decimal 

0177400!:m set search mask to third byte in word 

023000;= search between 100 octal and 1000 decimal and prints th 


dress and contents of each word if the value of that 
when logically ANDed with octal 177400 is equal to 
23000. A search not equal also searches between the 1 
in :8 and :9, ANDS each word with the mask in :m 
displays each word for which the resulting value doe 
equal the given value. 


Execution and Breakpoints 


The general format of the set breakpoint command is: 
<address expression>;b[<conditional expression>] 


which causes a breakpoint to be installed at location <address express 
When a conditional breakpoint is encountered during the course of e 
tion, the conditional expression is evaluated. If the value of the c 
tional expression is true (non-zero), the execution break occurs. I 
value is false the execution break does not occur, and execution cont 
in the normal fashion. A null conditional expression is always eval 
as true. 


The format of the conditional expression is: 


<relational expression>[<boolean operator><relational expression> 
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<boolean operator><relational expression>...] 


A conditional expression is thus composed of any number of relat 
operators separated by the boolean operator && (for AND) or | | (for 
Evaluation is strictly left to right (no parentheses). 


A relational expression is an address expression or two address expres 
separated by one of the relational operators: ==, !=,<,<=,>,>=. Ifa 
dress expression contains a symbol name then the value of the address 
pression is taken to be the contents of the memory cell addressed b 
expression. If an address expression contains no symbol name then the 
pression is taken literally (ie. the value of i1+4 is the contents o 
memory cell whose address is i1+4 while the value of 100+4 is 104). 


expression 104@ has the value of the contents of memory cell 104. 


CAUTION: blanks are meaningful to ddt and are equivalent to the add 
(+) operator. 


The command ;d displays each active breakpoint along with any condit 
expression associated with each. 


Some valid conditional expressions are: 
KX 
i1>=0100 
funl:argl!=1&&ii<12 
j1| 152 
0177203@==0177777 


Upon encountering a breakpoint, ddt displays the instruction which wil 
executed when execution continues and ddt then goes into the command m 


funl;b sets a breakpoint at the entry point of function funl 
7g abc filea starts execution of the symbolic(a.out) file at locati 
passing to it the arguments abc and filea. 
XXX; C clear the breakpoint at location xxx 
ra clear all breakpoints 
DIAGNOSTICS 


Self-explanatory (?) diagnostics are given for illegal or unrecognized 
mands. 


SEE ALSO 


BUGS 


ec(I), C Reference Manual 


The $ (stack trace) command always prints at least 2 arguments for 
function, even those with fewer than 2 actual arguments. 


Local function symbols (auto, static, and register) are not accessibl 
the current Interdata implementation —- only external symbols. 


Ddt can not be used interactively with FORTRAN (or ratfor) programs, 
the illegal supervisor calls normally handled by the `OS/MT SVC Emul 
are intercepted by ddt. 
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When proceeding from a breakpoint ddt removes the breakpoint tempora 
and replaces it only when a different breakpoint is encountered. 
means any loop being debugged interactively should contain at least 
breakpoints. 


Occasionally ddt may leave breakpoints set in the a.out file after it 
its, making it impossible to execute the program. It is advisable to 
a copy of valuable programs before debugging them interactively. 


DFI (TI) 8/12/77 DETTI) 


NAME 
dfi - list files on Interdata OS/MT disc 
SYNOPSIS 
dfi [ -1 | device [ filename | 
DESCRIPTION 
Lists the files on the specified device, which must contain 
an Interdata OS/MT file system. 
=E Long listing - give type & size of files 
filename List only filenames which match the specified name 
{may contain shell argument meta-characters if es- 
caped). filename must be entered in uppercase! 
AUTHOR 
R Miller 
University of Wollongong 
SEE ALSO 
export (I), import (I) 
BUGS 


Doesn't know about "Dynamic OS/MT" directory format. 
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NAME 


export - copy a file to an Interdata OS/MT disc 


SYNOPSIS 
export device file [ recl ] 

DESCRIPTION 
Copies the specified file onto the device, which must con- 
tain an Interdata OS file system. The OS filename is formed 
by translating the UNIX filename to uppercase, and taking 
any characters after the last period as an extension. (Name 


and extension are truncated to 8 and 3 characters respec- 
tively.) 


The created file will be INDEXED, with a logical record 
length of recl (default 256). Note that export does not 
format the file into fixed-length records: recl is used only 
to initialize the OS directory entry. 


AUTHOR 


R Miller 
University of Wollongong 


SEE ALSO 


BUGS 


dfi(I), import (I) 


The OS disc must contain at least one directory block. 

No check is made for already existing files. This may 
result in multiple OS files with the same name. 

There is no way to delete an OS file . 

Doesn't know about "Dynamic OS/MT" directory format. 
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NAME 
ferr — Fortran error messages 


SYNOPSIS 
ferr error-—number ... 


DESCRIPTION 
Prints the error message(s) associated with each specified 
Fortran error number. 


Includes both compile-time and run-time errors. 
BUGS 


Error message text is copied from Interdata manuals. Mes- 
sages are ambiguous, misleading, and sometimes dead wrong. 


FORT (1) FORT (TI) 


NAME, 
fort — Interdata Fortran V compiler 
SYNOPSIS 
fort [ -l1 ] [ -c ] [ -S ] [ -o output ] file 
DESCRIPTION 
Invokes the Fortran V compiler. 
Arguments of the form name.f or name.for are assumed to be 
Fortran source programs; each is compiled and assembled and 
the object code is left in file name.o. The .o file is nor- 
mally deleted if only one source file is compiled. 
Source may contain lower-case letters and tabs. 
Each source file may contain only one main program or sub- 
program. 
Flags: 
Sl Make a listing on the standard output. 
= Compile only - suppress the loading phase, and don't 
delete the .o file. 
=$ (Uppercase S) Suppress the assembly phase, and leave 
the assembly-language version of each source file in 
name.s. 
a) Leave the executable program in file output instead of 
a.out. 
Other arguments are assumed to be loader flags (see Ild({I)), 
object libraries, or object programs produced by an earlier 
Fortran compilation. All the resulting object files are 
linked together with the Fortran runtime library to produce 
an executable program on file a.out. 
Files are linked in the order specified: the main program 
must be named first. 
At execution time, Fortran I/O units 5 and 6 are assigned to 
the standard input and output respectively. No other unit 
numbers are currently supported. 
DIAGNOSTICS 


For explanations of Fortran compile-time and run-time error 
numbers, use the ferr command (q.v.). 


FORT (T) FORT (TI) 


FILES 
/lib/frt0.o Fortran runtime initialization 
/lib/libf.a Fortran runtime library 
/lib/libd.a Fortran double-precision library 
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NAME 
import - copy a file from an Interdata OS/MT disc 


SYNOPSIS 
import device file [ outfile ] 


DESCRIPTION 
Reads the specified file from the device, which must contain 
an Interdata OS file system, and copies it onto outfile (if 
given) or to the standard output. 


import translates the filename to uppercase before searching 
the OS directory. 


AUTHOR 
R Miller 
University of Wollongong 


SEE ALSO 
dfi(I), export (I) 


BUGS 
Can only read INDEXED and CONTIGUOUS files. 
Doesn't know about "Dynamic OS/MT" directory format. 


LD(I) 8/16/73 LD(I) 
NAME 
lad -= link editor 
SYNOPSIS 
id [ -sulxrodn | [ output | name ... 
DESCRIPTION 


Lad combines several object programs into one; resolves 
external references; and searches libraries. In the sim- 
plest case the names of several object programs are given, 
and ld combines them, producing an object module which can 
be either executed or become the input for a further ld run. 
{In the latter case, the -r option must be given to preserve 
the relocation bits.) The output of ld is left on a.out. 
This file is made executable only if no errors occurred dur- 
ing the load. 


The argument routines are concatenated in the order speci- 
fied. The entry point of the output is the beginning of the 
first routine. 


If any argument is a library, it is searched exactly once at 
the point it is encountered in the argument list. Only 
those routines defining an unresolved external reference are 
loaded. If a routine from a library references another rou- 
tine in the library, the referenced routine must appear 
after the referencing routine in the library. Thus the ord- 
er of programs within libraries is important. 


Ld understands several flag arguments which are written pre- 
ceded by a `-'. Except for -1, they should appear before 
the file names. 


-s ‘squash' the output, that is, remove the symbol table 
and relocation bits to save space (but impair the use- 
fulness of the debugger). This information can also be 
removed by strip. 


-u take the following argument as a symbol and enter it as 
undefined in the symbol table. This is useful for load- 
ing wholly from a library, since initially the symbol 
table is empty and an unresolved reference is needed to 
force the loading of the first routine. 


=1 This option is an abbreviation for a library name. =r 
alone stands for `/lib/liba.a', which is the standard 
system library for assembly language programs. =l 
stands for `/lib/libx.a' where x is any sequence of 
characters. A library is searched when its name is en- 
countered, so the placement of a -1 is significant. 


-x do not preserve local (non-extern) symbols in the output 
symbol table; only enter external symbols. This option 
saves some space in the output file. 


LD(I) 
-X 
—-r 
-— 
-d 
—n 
FILES 
SEE ALSO 
as 
BUGS 
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Save local symbols except for those whose names begin 
with “L'. This option is used by ce to discard inter- 
nally generated labels while retaining symbols local to 
routines. 


generate relocation bits in the output file so that it 
can be the subject of another ld run. This flag also 
prevents final definitions from being given to common 
symbols, and suppresses the “undefined symbol' diagnos- 
tics. 


the executable output is placed on the file output in- 
stead of a.out. 


force definition of common storage even if the -r flag 
is present. 


Arrange that when the output file is executed, the text 
portion will be read-only and shared among all users ex- 
ecuting the file. This involves moving the data areas 
up the the first possible 64k word boundary following 
the end of the text. 


/lib/lib?.a libraries 
a.,out output file 


(I), ar (I) 
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NAME 


log - hardcopy log of terminal session 


SYNOPSIS 


log [| file ] 


DESCRIPTION 


After log is executed, all subsequent terminal I/O is logged 
onto file. Both input and output are copied onto the file, 
interspersed in the same order as they appear on the termi- 
nal. 


If file is omitted, log forces the shell's standard output 
to the terminal (file descriptor 2) and logs I/O on the log 
command's standard output. Thus log can be used as a 
filter; e.g. 


oe 


log | opr 


To terminate logging, type ctri-d. 


AUTHOR 


BUGS 


R Miller 
University of Wollongong 


Since log is implemented with pipes, any program which tries 
to read from fd 1 or write to fd 0 (e.g. Interdata BASIC IT) 
cannot be logged. 


MC (I) MAR/76 
NAME 
mc — filter which splits output into columns 
SYNOPSIS 
mc [tm] [-n] [file] 
DESCRIPTION 


me reads from the standard input ( or “file™ if 


MC (T) 


the argument 


is given ) and writes to the standard output splitti 
many lines as possible per line. “-n" sets the line 
{default 80) and "tm" sets the number of blanks to be p 
ed between input lines (default 2). 
EXAMPLES 
ls * me 
nm /net/caltech/unix mc —130 | pr -h "Cal conf" lpr 
AUTHOR 
University of Toronto 
BUGS 
It should break on lines terminated by a :. This would 


low ls dirl dir2*mc to work. 


ng as 
width 
ELRES 


al- 
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NAME, 
press — compress a file 

SYNOPSIS 
press [ — ] [ infile [ outfile ] ] 

DESCRIPTION 
Compresses input file by replacing strings of 4 or more 
identical characters by a single character and a count. The 
'—' option expands a previously compressed file. 
Usable as a filter. 
Generally useless with UNIX text files, but saves space with 
"fixed-record-length" files {e.g. imported from Interdata) 
containing lots of blanks. 

AUTHOR 


R Miller 
University of Wollongong 


RATFOR (I) () RATFOR (I) () 


NAME 
rc — RATFOR compiler 

SYNOPSIS 
re [-c] [-f] [-r] [-v] name.r 

DESCRIPTION 
rc invokes the RATFOR preprocessor on a set of RATFOR source 
files. It accepts the following arguments: 
Arguments whose names end with '.r' are taken to be RATFOR 
source programs; they are preprocessed into FORTRAN and com- 
piled. Each subroutine or function 'name' is placed on a 
separate file 'name'.f and its object code is put on 
'name'.o. The main program is put on MAIN.£ and MAIN.o ; 


block data subprograms go on 'blockdata'.f and The resulting 
aaa o files are linked together onto a file called a.out 
The following flags are interpreted by rc. 


=C Suppress the loading phase of compilation, as does any error 
=f Save FORTRAN intermediate files. Used for debugging only. 
=r RATFOR only; dont't try to compile the FORTRAN. 

a i Don't list intermediate file names while compiling. 
EXAMPLES: 


re test.r 
a.out 


The above will compile a RATFOR program on file test.r then 
execute the resulting binary on a.out. 
Every program should contain the statment: 


include rat.h 

This will include the standard definitions for all the sym- 
bols in upper case as used in Software Tools. To use these 
symbols you must type them in in upper case; e.g. 


while((c=getc(c)) != EOF) ....... 


To enter the special characters required by RATFOR on = your 
terminal please follow the following conventions: 


TO ENTER TYPE 
not equal {= 
{ \¢ 
} \) 

! 


or ! 
A Na Or any upper case character 
# # 


RATFOR (I) () RATFOR (I) () 


DIAGNOSTICS 

Yes-- it is entirely possible to get diagnostics ei- 
ther from RATFOR or from FORTRAN. If RATFOR finds errors in 
your proogram you will receive the message “syntax errors — 
please list ratjunk"™ on your terminal. If this occurs enter 
cat ratjunk to get a listing of both the FORTRAN generated 
by RATFOR and the error messages. In these errors the line 
numbers given refer to lines in your RATFOR program. TE 
RATFOR does not find any errors in your program he will call 
FORTRAN to compile the generated Fortran. If FORT finds 
errors it will produce diagnostics directly on your termi- 
nal. The line number in these messages refer to line in the 
FORTRAN program which is now on a file called MAIN.f for the 
main program or on 'name'.f for subprograms. 


RKDUMP (T) RKDUMP (T) 


NAME 


rkdump — convert PDP-11 filesystem image to dump format 


SYNOPSIS 


rkdump [fsb] [outfile] file 


DESCRIPTION 


rkdump reads the named file, which is assumed to be an image 
of a PDP-11 UNIX filesystem volume, and produces an incre- 
mental dump tape on /dev/mt0. The dump tape can then be ex- 
tracted to an Interdata UNIX filesystem by restor (VIII). It 
is useful mainly for examining the Bell Labs distribution 
tape. 


Dump format and flags are the same as for the dump command. 
£ Write the dump file to outfile instead of tape. 
s Specify tape size in feet 


b Specify tape size in blocks 


SEE ALSO 


dump (VIII), restor (VIII) 


TC (TI) 
NAME, 
te - tape commands 
SYNOPSIS 
te [-N] command [count] 
DESCRIPTION 
Position the tape on drive /dev/mtN 
are: 
EE Forward Space File 
bf Back Space File 
wf Write File Mark 
fr Forward Space Record 
br Back Space Record 
rw Rewind 


If count is specified, the command is 


TEE) 


(default mt0O). Commands 


repeated count times. 


TM(I) TM(I) 


NAME 
tm - map of records and filemarks on magtape 


SYNOPSIS 
tm) [ANID ESEN] [FEN] ile] 
DESCRIPTION 
Read the tape on drive /dev/mtN (default mt0) and print a 
summary of record lengths and tapemarks. Output lines have 
the form 
L:N 
(N records of length L), or 
tm:N 


(N tapemarks). 
-tN stop after N consecutive tapemarks (default: 2) 
-rN stop after N records 
-e continue even if I/O errors occur 
AUTHOR 


R Miller 
University of Wollongong 
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NAME, 
xlib - extract modules from Interdata object library 
SYNOPSIS 
xlib libfile directory 
DESCRIPTION 
Extracts programs from file libfile, which must be an Inter- 
data OS object library, and copies them into the specified 
directory. 
For each binary label xxx encountered in the library, xlib 
creates a file xxx.obj containing all input records up to 
the next binary label or EOF. 
AUTHOR 
R Miller 
University of Wollongong 
SEE ALSO 


cvo (T) 
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NAME 
rti - return from signal trap 

SYNOPSIS 
rti(ps, pc, sp); 

DESCRIPTION 
rti executes a signal 0, causing the PSW status, program 
counter and stack pointer to be given the values of the 
three arguments. The PSW status is first verified to 
prevent user processes from getting into an "unauthorized" 
state. 
See signal (II) for details. 

SEE ALSO 


signal (II) 
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NAME, 
signal, csignal - catch or ignore signals 


DESCRIPTION 
The signal mechanism is as described in The Book, with the 
following addition: 


Since the Interdata has no rti instruction, a special signal 
0 call allows signal routines to return to the point of 
interruption without disturbing registers or the PSW. 


When a caught signal occurs, UNIX first checks whether the 
process has a stack (see below); if not, the stack pointer 
is initialized to the top of the stack segment - 512. UNIX 
then stacks the old SP value, program counter, and PSW 
status (in reverse order) and transfers to the process's 
signal routine. 


An assembler signal routine can return to the point of 
interruption by executing signal 0. UNIX then restores the 
PSW status, program counter, and previous SP value from the 
stack. (The PSW status is verified to prevent processes get- 
ting into an "unauthorized" state.) 


If the high-order bit of the restored PSW is on, the process 
is to be resumed in "no stack" mode. This is normally used 
only in "foreign" programs running under the OS SVC inter- 
preter, which do not observe the UNIX stack discipline. 


A C signal function normally cannot return - it must only 
clean up and exit, or call reset to re-initialize the stack. 
However, a special version of signal exists (as csignal ()) 
which includes a pseudo-rti. Using this version, the 
process's signal function is called with the interrupt—time 
register values as arguments; i.e. 


func(r0, rl, r2, ... , ve, rf, ps, pc); 
When the function returns, csgnal restores registers and PSW 
from the arguments (which may have been altered) and resumes 


execution at address pc. 


SEE ALSO 
rti(II) 


STAT (II) STAT (IT) 


NAME, 
stat - get file status 


SYNOPSIS 
stat equ 18 
svc stat 
dc name, buf 


stat(name, buf) char *name; struct inode *buf; 


DESCRIPTION 
Name points to a null-terminated string naming a file; buf 
is the address of a 17(10) word buffer into which informa- 
tion is placed concerning the file. It is unnecessary to 
have any permissions at all with respect to the file, but 
all directories leading to the file must be readable. After 
stat, buf has the following structure 


struct inode { 


int idev; /* major/minor device of i-node */ 
int inumber; /* i-node number */ 

int flags; /* see below */ 

char nlinks; /* number of links to file */ 

char uid; /* user ID of owner */ 

char gid; /* group ID of owner */ 

char size0; /* unused */ 

int sizel; /* file size */ 

int addr[8]; /* block numbers or device number */ 
int actime [2]; /* time of last access */ 

int modtime [2]; /* time of last modification */ 


1; 
The flags are as follows: 


100000 i-node is allocated 
060000 2-bit file type: 
000000 plain file 
040000 directory 
020000 character-type special file 
060000 block-type special file. 
010000 large file 


004000 set user-ID on execution 
002000 set group-ID on execution 
001000 save text image after execution 


000400 read (owner) 
000200 write (owner) 


000100 execute (owner) 

000070 read, write, execute (group) 

000007 read, write, execute (others) 
SEE ALSO 


ls (I), fstat (II), fs (V) 


STAT (II) STAT (IT) 


DIAGNOSTICS 
Error bit (c-bit) is set if the file cannot be found. From 
C, a -1 return indicates an error. 


STTY (II) STTY (IT) 


NAME 
stty - set mode of typewriter 


SYNOPSIS 

stty equ 31 

(file descriptor in r0) 
svc stty 
dc arg 

arg db 0,0, ISPEED, OSPEED 
db 0,0,ERASE, KILL 
dc MODE 


stty(fildes, arg) 
struct { 


char pad0 (2); 
char ispeed, ospeed; 
char padi (2); 
char erase, kill; 
int mode; 
} *arg; 
DESCRIPTION 


Stty sets mode bits and character speeds for the typewriter 
whose file descriptor is passed in r0 (resp. is the first 
argument to the call). First, the system delays until the 
typewriter is quiescent. The input and output speeds are 
set from the first word of the argument structure as indi- 
cated by the following table. Impossible speed changes are 
ignored. 


{hang up dataphone) 
50 baud 

75 baud 
110 baud 
134.5 baud 
150 baud 
200 baud 
300 baud 
600 baud 
1200 baud 
10 1800 baud 
11 2400 baud 
12 4800 baud 
13 9600 baud 
14 External A 
15 External B 


GOJA bW HG 


In the current configuration, only 300. 1200, 2400 and 4800 
baud are really supported, 


The next two characters of the argument structure specify 
the erase and kill characters respectively. (Defaults are # 
and @.) 
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The mode contains several bits which determine the system's 
treatment of the typewriter: 


100000 Select one of two algorithms for backspace de- 
lays 

040000 Select one of two algorithms for form-feed and 
vertical-tab delays 

030000 Select one of four algorithms for carriage- 
return delays 

006000 Select one of four algorithms for tab delays 

001400 Select one of four algorithms for new-line de- 
lays 

000200 even parity allowed on input (e. g. for M37s) 

000100 odd parity allowed on input 

000040 raw mode: wake up on all characters 

000020 map CR into LF; echo LF or CR as CR-LF 

000010 echo (full duplex) 

000004 map upper case to lower on input (e. g. M33) 

000002 echo and print tabs as spaces 

000001 hang up (remove “data terminal ready,' lead CD) 
after last close 


The delay bits specify how long transmission stops to allow 
for mechanical or other movement when certain characters are 
sent to the terminal. In all cases a value of 0 indicates 
no delay. 


Backspace delays are currently ignored but will be used for 
Terminet 300's. 


If a form—-feed/vertical tab delay is specified, it lasts for 
about 2 seconds. 


Carriage-return delay type 1 lasts about .08 seconds and is 
suitable for the Terminet 300. Delay type 2 lasts about .16 
seconds and is suitable for the VTOS and the TI 700. Delay 
type 3 is unimplemented and is 0. 


New-line delay type 1 is dependent on the current column and 
is tuned for Teletype model 37's. Type 2 is useful for the 
VTOS and is about .10 seconds. Type 3 is unimplemented and 
Eit e 0 A 


Tab delay type 1 is dependent on the amount of movement and 
is tuned to the Teletype model 37. Other types are unimple- 
mented and are 0. 


Characters with the wrong parity, as determined by bits 200 
and 100, are ignored. 


In raw mode, every character is passed immediately to the 
program without waiting until a full line has been typed. 
No erase or kill processing is done; the end-of-—file charac- 
ter (EOT), the interrupt character (DEL) and the quit char- 
acter (FS) are not treated specially. 


STTY (II) STTY (IT) 


Mode 020 causes input carriage returns to be turned into 
new-lines; input of either CR or LF causes LF-CR both to be 
echoed (used for GE TermiNet 300's and other terminals 
without the newline function). 


The hangup mode 01 causes the line to be disconnected when 
the last process with the line open closes it or terminates. 
It is useful when a port is to be used for some special pur- 
pose; for example, if it is associated with an ACU used to 
place outgoing calls. 


This system call is also used with certain special files 
other than typewriters. For its use with magtape see 
mt (IV). 


SEE ALSO 
stty (I), gtty (II), mt (IV) 


DIAGNOSTICS 
The error bit (c-bit) is set if the file descriptor does not 
refer to a typewriter. From C, a negative value indicates 
an error. 


DSK (IV) DSK (IV) 


NAME 
dsk — 10-megabyte disk 


DESCRIPTION 
df? and dr? refer to the fixed and removable platter 
respectively of a 10-megabyte cartridge disk drive. Each 


has 512-byte blocks numbered 0 to 9791. 


The files access the disk via the system's normal buffering 
mechanism and may be read and written without regard to phy- 
sical disk records. There is also a “raw" interface which 
provides for direct transmission between the disk and the 
user's read or write buffer. A single read or write call 
results in exactly one I/O operation, and therefore raw I/O 
is considerably more efficient when many bytes are transmit- 
ted. The names of the raw disk files are formed by prefix- 
ing “r' to the name of the corresponding disk. 


In raw I/O the buffer must begin on a halfword boundary, and 
counts should be a multiple of 512 bytes (a logical disk 


block). Likewise seek calls should specify a multiple of 
512 bytes. 
FILES 
Name Device Address 
/dev/dr0 0/0 c6 removable disk (right-hand cabinet) 
/dev/d£0 0/1 cT fixed disk " 
/dev/drl 0/2 d6 removable disk (left-hand cabinet) 
/dev/dfl 0/3 d7 fixed disk h 
/dev/rdf?, /dev/rdr? raw disks 


MEM (IV) MEM (IV) 
NAME 
mem, kmem, null — core memory 
DESCRIPTION 
mem is a special file which is an image of the core memory 
of the computer. It may be used, for example, to examine 
and even to patch the system using ddt. 
The file kmem is the same as mem except that kernel-mode 
virtual memory rather than physical memory is accessed. In 
particular, the area beginning at x'E0000' is the system's 
data area for the current process, including the kernel-mode 
stack. 
The file null returns end-of-file on read and ignores write. 
FILES 
/dev/mem, /dev/kmem, /dev/null 


MT (IV) MT (IV) 


mt — magnetic tape drive 


DESCRIPTION 


The file mtO refers to the 800-bpi magnetic tape drive. The 
tape is automatically rewound when closed; if the last 
operation was a write, two filemarks are written first. 


A standard tape consists of a series of 512-byte records 
terminated by a filemark. To the extent possible, the sys- 
tem makes it possible, if inefficient, to treat the tape 
like any other file. Seeks have their usual meaning, and it 
is possible to read or write a byte at a time. Writing in 
very small units is inadvisable, however, because it tends 
to create monstrous record gaps. 


The interface discussed above is useful when it is desired 
to access the tape in a way compatible with ordinary files. 
When foreign tapes are to be dealt with, and especially when 
long records are to be read or written, the “raw" interface 


is appropriate. The associated raw tape file is named rmt0. 
Each read or write call reads or writes the next sequential 
record on the tape. In the write case the record has the 


same length as the buffer given. During a read, the record 
size is passed back as the number of bytes read, provided it 
is no greater than the buffer size; if the record is long, 
an I/O error is indicated. In raw tape I/o, the buffer must 
begin on a halfword boundary and the count must be even. 
Seeks are ignored. End-of-file status is returned when a 
tape mark is read (or when the end of the tape is reached) 
but another read will fetch the first record of the next 
tape file. 


The files mmtO and rmmt0O are identical to the corresponding 
mt files, but are not rewound automatically; they may be 
used to access a tape containing multiple files. Tape posi- 
tioning operations are performed on an open rmmt file by a 
stty call. The first word of the parameter list is one of 
the following: 

Q — forward space file 


1 - back space file 
3 - write filemark 
4 — forward space record 
5 = back space record 
7 — rewind 
The second and third words must be 0. (These operations are 


also performed by the tc command.) 


/dev/mtO, /dev/mmt 0 
/dev/rmt0, /dev/rmmt 0 


MT (IV) 


MT (IV) 


SEE ALSO 


BUGS 


te(I), tm(I), tp(T) 


A rewind or backspace operation from loadpoint will hang up 
the controller. This condition must be cleared manually by 
a reset—forward-reset—online sequence. 


An attempt to write to a tape without a write ring will also 
hang up the controller. This must be cleared manually by a 
reset—online sequence. 


A gtty call should be provided to return the status of the 
drive. 


PALS ( 


NAME 


IV) PALS (IV) 


pals — PALS local terminal interface 


DESCRIPTION 


Local terminals connected via the PALS interface behave as 
described in tty (IV). 


Device numbers 0/0, 0/1, 0/2 ... correspond to addresses 
TO Ken x'14' etc. Available baud rates and 
corresponding PALS ‘command 2' values (see boot (VIII)) are: 
baud cmd2 
300 38 
1200 78 
2400 B8 
4800 F8 
FILES 
/dev/tty? 
SEE ALSO 


tty (IV), stty(I), ttys(V), init (VIII) 
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NAME, 
a.out — link editor format 


DESCRIPTION 
The a.out file produced by as and accepted by ld has the 
format of a PDP-11 UNIX a.out file, with the following 


differences: 

Magic number The magic number is a 32-bit fullword. 
Header The header is 8 words (32 bytes) long. 
Symbol table Each entry is 4 words (16 bytes) long, con- 


taining an 8-character name, one-word type 
and one-word value. 


Relocation bits There is one 16-bit halfword of relocation 
bits per halfword of text and data. Bit 0 
of the relocation halfword indicates, if on, 
that the corresponding text or data halfword 
is the high-order 16 bits of a fullword re- 
locatable address; and the next relocation 
halfword is zero for a 24-bit address or 
nonzero for a 32-bit address. 


SEE ALSO 
The Book 


ARCHIVE (V) ARCHIVE (V) 


NAME, 
archive - ar (library) file format 
DESCRIPTION 
The archive command ar is used to combine several files into 
one. Archives are used mainly as libraries to be searched 
by the link-editor ld. 
A file produced by ar has a magic number 0177545(8) in the 
first word, followed by the constituent files, each preceded 
by a file header. The header of each file has the following 
format: 
struct { 
char name [14]; /* file name, null padded */ 
char uid; /* user id of file's owner */ 
char gid; /* group id of file's owner */ 
long date; /* time of last modification */ 
long size; /* size of file */ 
int mode; /* access modes */ 
hi 
Each file begins on an even address; a null byte is inserted between 
files if necessary. 
Nevertheless the size given reflects the actual size of the 
file exclusive of padding. 
Notice there is no provision for empty areas in an archive file. 
SEE ALSO 


ar(I), ld(T) 


CORE (V) CORE (V) 


NAME 


core — format of core image file 


DESCRIPTION 


UNIX writes out a core image of a terminated process when 
any of various errors occur. See signal (II) for the list 
of reasons; the most common are memory violations, illegal 
instructions, address errors, and user-generated quit sig- 
nals. The core image is called “‘core'' and is written in 
the process's working directory (provided it can be; normal 
access controls apply). 


The first 1536 bytes of the core image are a copy of the 
system's per-user data for the process, including the regis- 
ters as they were at the time of the fault. The remainder 
represents the actual contents of the user's core area when 
the core image was written. If the text segment is write- 
protected and shared, it is not dumped; otherwise the entire 
address space is dumped. 


The format of the information in the first 1536 bytes is 
described by the user structure of the system (see 
/usr/sys/user.h). 


In general the debugger ddt (I) is sufficient to deal with 
core images. 


SEE ALSO 


ddt (I), signal (II) 
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NAME, 
fs - format of file system volume 


DESCRIPTION 
The format of a file system volume is slightly different 
from that described in The Book, because of the Interdata's 
32-bit word length. 


Differences are: 


super—block The free[] and inode[] arrays each hold 50 
fullword pointers, not 100. 


freelist Free list index blocks contain 50 free-block 
pointers, not 100. 


inode The iaddr[] array holds 8 fullword block 
numbers, so the inode is 64 bytes long. 
Thus inode i is located in block (i+15)/8, 
at offset 64*(i+15) (mod 8) bytes from the 
beginning of the block. 


indirect block Each indirect block holds 128 fullword block 
numbers, not 256. The large file argorithm 
is changed accordingly. 


directory A directory entry is 16 bytes long: a half- 
word i-number, and a 14-character filename. 
SEE ALSO 
The Book 
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NAME, 
ttys - typewriter initialization data 


DESCRIPTION 
The format of the ttys file is as described in The Book. 


The third character in each line identifies the type of ter- 
minal. Current types at the University of Wollongong are: 

= Carousel: 300 baud 

0 Local VDU: 300 baud 

2 Local VDU: 1200 baud 

4 Local VDU: 2400 baud 

5 Local VDU: 4800 baud 


FILES 
/etc/ttys 


SEE ALSO 
The Book 


UTMP (V) 


NAME 


utmp - user information 


DESCRIPTION 


UTMP (V) 


This file contains information about users currently logged 


in to UNIX. 


The format of a utmp file entry is: 


struct { 


char 
char 
int 
int 
} 
FILES 
/etc/utmp 
SEE ALSO 


The Book 


name [8]; 
tty; 

time [2]; 
unused; 


/* user's login name, blank-—padded on 
/* last char of tty name */ 
/* login time */ 


ATTACH (VIIT) ATTACH (VIII) 


NAME 
attach — logically connect terminals 


SYNOPSIS 
fetc/attach ttyid ... 


DESCRIPTION 
attach starts a login process on the named terminals 
{single-character id's only) by changing the /etc/ttys file 
and sending a hangup signal to the init process. 


FILES 
/etc/ttys 


SEE ALSO 
ttys(V), init (VIII), detach (VIII) 


BOOT (VIII) BOOT (VIII) 


NAME 
boot - how to boot UNIX 


DESCRIPTION 
UNIX is normally loaded by reading an a.out-format file from 
the root filesystem into memory. This is done by the uboot 


bootstrap program, which can be loaded by the LSU (Loader 
Storage Unit) or from magtape. 


Bootstrap Procedure From Disc 


l. Make sure low-core device definitions are set up as 
described below, and the console tty is online. 

2. Turn the LSU “enable' switch on. 

3. Press the INI switch. A `?' prompt should appear on 
the console. 

4, If UNIX is to be started in single-user mode, enter 
the value x'F618' into the display-panel switch regis- 
ter (DTA F618 RUN). 

5. Type on the console the name of a file in the root 
directory to be loaded (normally unix). 

6. When UNIX is initialized, the amount of user memory 
available is printed on the console. In single-user 
mode, the console is automatically logged in as the 
super-user and a `#' prompt appears; otherwise, a lo- 
gin process is started on each terminal listed in the 
/etc/ttys file. 

7. Turn the LSU ‘enable' switch off. 

8. If rebooting after a crash, use icheck to check file 
system integrity. Use date to set the date and time. 


Low-Core Initialization for Disc Boot 


Address Value Meaning 

78 10 console address 

79 38 PALS “Command 2' to initialize console 
TA Cc? boot disk address 

7B 32 LSU disk type code (32:fixed 33:removable) 
TC B6 controller address 

7D FO selch address 

7E-7F 0000 OS/MT `file extension' for LSU 

80-81 0000 

82-83 100 PSW save area (any value >=100 is OK) 
84-85 100 register save area 


Loading uboot From Magtape 


1. Set up '50 sequence' low-core definitions as described 
below. 

2. Mount the tape containing the uboot image on drive 0. 

3. Execute at location x'30' (DTA 30 ADD RUN). The tape 


moves and a `?' prompt should appear on the console. 
4. Follow steps 4-8 as for disk. 
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Low-Core Initialization for Tape Boot 


Address Value Meaning 
30=33 0000 0050 illegal instruction new PSW 
50-53 D500 0300 al x'300' load from tape 
54-57 4300 0080 b x'80' branch to loaded program 
78 85 magtape address 
79 Al magtape read command 
7A-7D as for disk boot 
7E 10 console address 
{copied to x'78' by uboot) 
SE 38 PALS `command 2' to initialize console 
80-85 as for disk boot 


How it Works 
The uboot program has been copied onto the disk (after the 
swap area) by the mkboot command. mkboot also initialized 
block 0 of the disk to look like an OS/MT ‘volume descrip- 
tor', which the LSU uses to locate the uboot image. If ei- 
ther of these areas has been corrupted, the LSU operation 
will fail and no `?' prompt will appear; uboot must then be 
loaded from a backup disk or magtape. 


Once loaded, uboot relocates itself to address x'20000', 
reads a filename from the console, and searches for the file 
in the root directory. If a disk I/O error occurs, uboot 
goes into a one-instruction loop; if the file is not found, 
it repeats the `?' prompt. Otherwise, the file is read into 
core at address 0 (skipping the a.out header), and executed 
beginning at x'60'. 


Alternate System Devices 


In case of hardware or other problems, UNIX can be loaded 
from a removable backup disk or with a different console 
tty, by changing the low-core device definitions. Once the 
system is loaded, it may also need to be reconfigured before 
it begins execution, by changing values in a fixed confi- 
guration area in the UNIX kernel, described below. 


To change the configuration area: 
1. Follow the normal bootstrap procedure, but type the 


boot filename preceded by a hyphen (e.g. -unix). 

2. uboot will load the file and then halt (WAIT light 
goes on). 

3. Use the display panel to patch configuration values in 


core {DTA address ADD DTA hi-halfword WRT DTA lo- 
halfword WRT). 
4. Execute at x'60' (DTA 60 ADD RUN). 


The new configuration values may later be patched in the 
a.out file itself using ddt. 
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UNIX Kernel Configuration Area 


Name Address Value Meaning 
{fullword) 

trmask 404 0 debugging trace mask 

memtop 408 40000 maximum possible memory 

consdev 40C 0 console device number (major/minor 

logical device - NOT address) 

rootdev 410 1 root device number 

swapdev 414 $ swap device number 

swplo 814 1F40 location of swap area on disk 

nswap 41C 640 size in blocks of swap area 
N.B.: The values consdev, rootdev and swapdev are UNIX logi- 
cal device numbers (not hardware addresses), each consisting 
of a major and minor device number in the low-order two 
bytes of the word. For information on device numbers and 


PALS commands, see dsk (IV), pals(IV). 


SEE ALSO 
mkboot (VIII), icheck(VIII), dsk(IV), pals(IV) 
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NAME 
crash - what to do if the system crashes 

DESCRIPTION 
The description in the UNIX Programmer's Manual 
(crash (VIII)) contains much good advice. In addition, the 


following notes may be useful. 


If the system stops with a hang or loop, a panic should be 
forced, to cause a sync to update the file system. A 
“display console interrupt' can be generated by pressing 
FN 0; this causes UNIX to display the current PSW and stop 
with a "Panic: display console" message. 


To dump core to magtape: mount a tape on drive 0 and use the 
display panel to start execution at address x'66' (DTA 66 


ADD RUN). This will write all of memory to the tape in 8k 
blocks, followed by a filemark. The tape may be copied to 
/usr/sys/core and examined with ddt. The command 

ps aklx 


will use the /usr/sys/core file to display the status of all 
processes at the time of the crash. 


Some interesting locations in a dump are: 


uregs - contents of user register set 
eregs - contents of kernel register set 
kaé — points to the kernel segmentation register for 


the current per-process data area, which contains 
the kernel-mode stack 

uisad — user-mode segmentation registers 

trbuff - a circular trace buffer (in Interdata ‘list' 
format): see below 


If the crash is reproducible, it may be useful to turn on 


debugging trace messages. The address x'404' (trmask) is a 
trace mask which may be patched with ddt or the display 
panel. Each `1' bit causes a different dynamic trace mes- 


sage to be logged on the console tty. Sorry, the messages 
are not documented yet: use 

grep “trace(" /usr/sys/*.c 
for a quick list. 


In addition, even when trmask is 0, the first word of each 
trace message and a one-word associated value are always 


stored in the circular list trbuff. This list may be exam— 
ined in a core dump for a record of the 64 most recent `sys- 
tem events' (interrupts, process switches, etc.). 


When repairing file systems with icheck PLEASE dismount them 
first. If the root disk must be patched, a syne and reboot 
MUST be performed immediately afterwards. 
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NAME 
detach - logically disconnect terminals 

SYNOPSIS 
/etc/detach ttyid ... 

DESCRIPTION 
detach logically disconnects the named terminals {single— 
character id's only) by changing the /etc/ttys file and 
sending a hangup signal to the init process. Any currently 
active shells will be terminated. 

FILES 
/etc/ttys 

SEE ALSO 


ttys(V), init (VIII), attach (VIII) 
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NAME, 
mkboot - convert a.out file to LSU bootstrap image 

SYNOPSIS 
mkboot [ -block | file device 

DESCRIPTION 
Reads file, which must be an executable a.out file, and 
copies it onto device beginning at block number block (de- 
fault 9600) as an operating system image to be loaded by the 
LSU {loader storage unit). mkboot also writes an Interdata 
OS/MT 'volume descriptor' onto block 0 with a pointer to the 
bootstrap image. 

DIAGNOSTICS 
mkboot reads the superblock of device before copying, and 
gives an error message if the target area would overlap the 
file system. 

AUTHOR 


R Miller 
University of Wollongong 


